org.globalplatform
Interface Personalization

All Superinterfaces:

javacard.framework.Shareable

public interface Personalization
extends javacard.framework.Shareable

This interface defines a method through which an Application may forward input data to another Application and retrieve output data from that Application.

This interface shall be implemented by an Application that wishes to receive personalization data forwarded by its associated Security Domain and request outputting response data. In such a scenario, if the Application implements both the Application and the Personalization interface, then the Security Domain shall use the Personalization interface.

Since:

export file version 1.2

See Also:

Application

Method Summary

short

processData(byte[] inBuffer, short inOffset, short inLength, byte[] outBuffer, short outOffset) Processes application specific data received from another on-card entity.

Method Detail

processData

short processData(byte[] inBuffer,
                  short inOffset,
                  short inLength,
                  byte[] outBuffer,
                  short outOffset)

Processes application specific data received from another on-card entity.

If the Application invoking this method is a Security Domain then it shall be assumed that:

• Both the inBuffer and outBuffer byte arrays are global byte arrays;
• The data forwarded by the Security Domain is a STORE DATA command. The sOffset parameter locates the class byte of the command and the sLength parameter indicates the length of the entire command (i.e. header + data field).
• The Security Domain will send back to the off-card entity the output data written by the Application to outBuffer.
• Any exception thrown by this method will be rethrown by the Security Domain, hence will be converted to and returned as a response status word to the off-card entity. If the exception is an ISOException, then the status word will be the reason code of that exception. Otherwise, a status word of '6F00' will be returned.

Notes:

• Upon invocation of this method, the Java Card VM performs a context switch.
• As the Application is not the currently selected Application, it should not attempt to access transient memory of type CLEAR_ON_DESELECT during the processing of this method.
• The Application is responsible for managing the atomic modification of its own data, if needed.
• As this method may be invoked by a Security Domain immaterial of the Application's internal state, the Application is responsible for ensuring that its internal state is valid for this operation.

Parameters:

inBuffer - byte array containing input data. Must be a global byte array.

inOffset - offset of input data within inBuffer.

inLength - length of input data.

outBuffer - byte array where output data shall be written. Must be a global byte array.

outOffset - offset where output data shall be written within inBuffer.

Returns:

the number of bytes written to outBuffer.

Throws:

java.lang.SecurityException - if inBuffer or outBuffer is not a global byte array.

java.lang.NullPointerException - if inBuffer or outBuffer is null.

java.lang.ArrayIndexOutOfBoundsException - if reading intput data or writing output data would cause access of data outside array bounds.